home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat1 / wish.1 < prev   
Text File  |  1994-09-20  |  5KB  |  199 lines
  1.  
  2.  
  3.  
  4. wish(1)                  Tk Applications                      3.3
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      wish - Simple windowing shell
  12.  
  13. SYNOPSIS
  14.      wish ?_o_p_t_i_o_n_s? ?_a_r_g _a_r_g ...?
  15.  
  16. OPTIONS
  17.      -display _d_i_s_p_l_a_y
  18.                     Display (and screen) on which to display win-
  19.                     dow.
  20.  
  21.      -file _f_i_l_e_N_a_m_e Read commands from _f_i_l_e_N_a_m_e rather than stan-
  22.                     dard  input.   The  last  element in _f_i_l_e_N_a_m_e
  23.                     will be used as the title for the application
  24.                     and name of its interpreter for send commands
  25.                     (unless overridden by the -name option).
  26.  
  27.      -geometry _g_e_o_m_e_t_r_y
  28.                     Initial geometry to use for window.
  29.  
  30.      -name _n_a_m_e     Use _n_a_m_e as the title to be displayed in  the
  31.                     window,  and  as  the name of the interpreter
  32.                     for send commands.
  33.  
  34.      -sync          Execute all X server commands  synchronously,
  35.                     so  that  errors  are  reported  immediately.
  36.                     This will result in  much  slower  execution,
  37.                     but it is useful for debugging.
  38.  
  39.      -help          Print a summary of the  command-line  options
  40.                     and exit.
  41. _________________________________________________________________
  42.  
  43.  
  44. DESCRIPTION
  45.      Wish is a simple  program  consisting  of  the  Tcl  command
  46.      language, the Tk toolkit, and a main program that reads com-
  47.      mands from standard input or from a file.  It creates a main
  48.      window  and then processes Tcl commands.  If wish is invoked
  49.      with no -f option then it reads Tcl  commands  interactively
  50.      from  standard  input.  It will continue processing commands
  51.      until all windows have been deleted or until end-of-file  is
  52.      reached  on  standard input.  If there exists a file .wishrc  |
  53.      in the home directory of the user, wish evaluates  the  file  |
  54.      as  a  Tcl script just before reading the first command from  |
  55.      standard input.
  56.  
  57.      If the -file option is provided to Tk, then wish  reads  Tcl
  58.      commands  from  the  file  named in the -file option.  These
  59.      commands  will  normally  create  an  interactive  interface
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. wish(1)                  Tk Applications                      3.3
  71.  
  72.  
  73.  
  74.      consisting of one or more widgets.  When the end of the com-
  75.      mand file is reached, wish will continue  to  respond  to  X
  76.      events  until  all  windows  have been deleted.  There is no  |
  77.      automatic evaluation of .wishrc in this case, but the script  |
  78.      file can always source it if desired.
  79.  
  80.  
  81. VARIABLES
  82.      Wish sets the following Tcl variables:
  83.  
  84.      argc           Contains a count of the number of  _a_r_g  argu-
  85.                     ments  (0 if none), not including the options
  86.                     described above.
  87.  
  88.      argv           Contains a Tcl list whose  elements  are  the
  89.                     _a_r_g  arguments  (not  including  the  options
  90.                     described  above),  in  order,  or  an  empty
  91.                     string if there are no _a_r_g arguments.
  92.  
  93.      argv0          Contains _f_i_l_e_N_a_m_e if it was specified.   Oth-  |
  94.                     erwise,  contains  the name by which wish was  |
  95.                     invoked.                                       |
  96.  
  97.      tcl_interactive                                                    ||
  98.                     Contains   1  if  wish  is  reading  commands  |
  99.                     interactively (no -file option was  specified  |
  100.                     and  standard  input  is a terminal-like dev-  |
  101.                     ice), 0 otherwise.
  102.  
  103.  
  104. SCRIPT FILES
  105.      If you create a Tcl script in a file whose first line is
  106.  
  107.           #!/usr/local/bin/wish -f
  108.  
  109.      then you can invoke the script file directly from your shell
  110.      if  you  mark  it as executable.  This assumes that wish has
  111.      been installed in the default  location  in  /usr/local/bin;
  112.      if  it's installed somewhere else then you'll have to modify
  113.      the above line to match.
  114.  
  115.  
  116. PROMPTS
  117.      When wish is invoked interactively it normally  prompts  for  |
  118.      each command with ``% ''.  You can change the prompt by set-  |
  119.      ting the variables tcl_prompt1 and tcl_prompt2.  If variable  |
  120.      tcl_prompt1  exists  then it must consist of a Tcl script to  |
  121.      output a prompt;  instead of outputting a prompt  wish  will  |
  122.      evaluate   the   script   in   tcl_prompt1.    The  variable  |
  123.      tcl_prompt2 is used in a similar way when a newline is typed  |
  124.      but  the  current command isn't yet complete; if tcl_prompt2  |
  125.      isn't set then no prompt is output for incomplete commands.
  126.  
  127.  
  128.  
  129. Tk                                                              2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. wish(1)                  Tk Applications                      3.3
  137.  
  138.  
  139.  
  140. KEYWORDS
  141.      shell, toolkit
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Tk                                                              3
  196.  
  197.  
  198.  
  199.